home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / disk / av707.zip / AV.DOC next >
Text File  |  1997-07-31  |  12KB  |  254 lines
  1. AV.DOC                                 1                           Jul 31, 1997
  2.  
  3. WIN95 AND WINNT NOTICE:  As with most DOS-based utilities, this program doesn't
  4. understand the weird subdirectories, long filenames,  invalid  characters  that
  5. are possible under Windows 95 and Windows/NT.   Both  operating  systems  alias
  6. long filenames into names like MYFILE~1.TXT and you will need  to  specify  the
  7. aliased versions of file names to process  them.   Under  some  file  structure
  8. systems in NT, the program may not work at all.
  9.  
  10. The AV.EXE program shows a directory of one or more archive  files  (ZIP,  ZOO,
  11. etc), including some self-extracting files.  Features of this program:
  12.  
  13.   * The directory information is presented in full-screen mode and you can  use
  14.     PgUp and PgDn to scroll about the screens.
  15.   * Allows you to sort the display of the members in a number of ways.
  16.   * Allows you to reset the file date of the archive to match the date  of  the
  17.     most recent member of the archive.
  18.   * Provides the ability to filter out what members are displayed.
  19.   * Scroll through up to 500 archives.
  20.   * The date format shown is based on your country setting.
  21.   * Supports 43/50-line mode under EGA and VGA.
  22.   * Quick in-memory display for up to 50  archive  members;  bullet-proof  ISAM
  23.     support if it goes beyond that.
  24.  
  25.  
  26. A typical display might look (in part) like the following:
  27.  
  28. AV602.ZIP         Date      Time  OrigSize Method    NowSize  %reduce
  29. ------------  --------  -------- --------- -------- --------  -------[PgUp]
  30. AV.DOC        96/02/04  18:32:36      8585 Deflated     3395    61   [PgDn]
  31. AV.EXE        96/02/11  11:09:56    166744 Deflated   107879    36   [Home]
  32. BRUCE602.DOC  96/02/05  20:31:56     32493 Deflated    12566    62   [End]
  33. BRUCEINI.DOC  96/01/20  16:09:18      7649 Deflated     2891    63   [Up]
  34. FILE_ID.DIZ   96/01/28  12:26:36       214 Deflated      191    11   [Down]
  35.                                                                      [Sort]
  36.                                                                        [Name]
  37.                                                                        [Ext]
  38.                                                                        [Date]
  39.                                                                        [Size]
  40.                                                                        [CurSize
  41.                                                                        [Ratio]
  42.                                                                        [Path]
  43.                                                                        [Orig]
  44.                                                                        [-Flip]
  45.                                                                      [Filter]
  46.                                                                      [C-PgDn]
  47.                                                                      [C-PgUp]
  48.                                                                      [Quit]
  49.  
  50. ============  ========  ======== ========= ======== ========  =======[Help]
  51.  *5           96/02/11  11:09:56    215685            126922    42%  [Date]
  52. AV602.ZIP     96/02/11  11:10:16    127418                                  /ON
  53.  
  54.  
  55. Note that AV will not do much good for multi-disc ZIP files.
  56.  
  57. Since AV is based on a library of routines that is no longer  supported,  newer
  58. ZIP versions (including those generated by some Windows managers) will  not  be
  59. read properly by this command.
  60.  
  61.  
  62. AV.DOC                                 2                           Jul 31, 1997
  63.  
  64. When viewing a screen's worth of information, you can typically choose among  a
  65. number of options including the following:
  66.  
  67.         PgUp    view the previous screen's worth
  68.         PgDn    view the next screen's worth
  69.         Home    top line
  70.         End     bottom line
  71.         Up      move the screen up one line
  72.         Down    move the screen down one line
  73.         Sort    change the sort order for this and subsequent files;
  74.                 you're prompted for "BY?" and you should enter either
  75.                 "-x" or "x" or press Esc to get out of this: the archive
  76.                 is reread after you ask to re-sort it; x is one of:
  77.                         N = file name
  78.                         E = file extension
  79.                         S = file size of the original (non-compressed) file
  80.                         C = current (compressed) size of the file
  81.                         D = file date and time
  82.                         R = compression ratio
  83.                         P = path and file name order
  84.                         O = original order (no sorting)
  85.                 the "-" says to reverse the sort order (for example, biggest
  86.                 files first instead of last)
  87.         Filter  prompts you for a string; only member names that match that
  88.                 string are allowed through (does not accept wildcards; just say
  89.                 something like "COM" if you want all COM files)
  90.         Ctrl-PgDn go to the next archive file (if any)
  91.         Ctrl-PgUp go to the previous archive file (if any)
  92.         Quit    return to DOS (Ctrl-C also works) (with confirmation)
  93.         Date    update the archive file date to be the creation date of the
  94.                 most recent member in the archive; not offered if it's already
  95.                 the case
  96.         Del     delete the archive (with confirmation)
  97.         F1      help information
  98.         Alt-E   toggles between 25-line and 43-/50-line mode (if your
  99.                 system supports EGA and VGA respectively)
  100.  
  101. These options are presented on the right side of the screen and can be selected
  102. with the mouse cursor if one is available.
  103.  
  104.  
  105. Specifying parameters:
  106.  
  107. Parameters for this program can be set in the following ways.  The last setting
  108. encountered always wins:
  109.   - Read from an *.INI file (see BRUCEINI.DOC file),
  110.   - Through the use of an environmental variable (SET AV=whatever), or
  111.   - From the command line (see "Syntax" below)
  112.  
  113.  
  114.  
  115. AV.DOC                                 3                           Jul 31, 1997
  116.  
  117. Syntax:
  118.  
  119.     AV [ filespec ] [ /P | /-P ] [ /Ox | /O-x ] [ /DATE ] [ /-MOUSE ]
  120.       [ /Tpath ] [ /Q ] [ /EGA | /VGA ]
  121.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ] [ > filename ]
  122.  
  123. where:
  124.  
  125. "filespec" is the file specification to process.  Can include drive, path,  and
  126. wildcards if desired.  If no input filespec is provided, you'll be prompted for
  127. one.
  128.  
  129. "/P" (or "/PAUSE") says to view the directory in page mode.  This is  typically
  130. the default.  The default is automatically /-P (which can't be  overridden)  if
  131. redirection ("AV ...  > filename") is used.
  132.  
  133. "/-P" (or "/-PAUSE") says to  view  the  directory  not  in  page  mode.   This
  134. prevents you from being offered the fix-date option  as  well.   This  mode  is
  135. automatic if redirection ("AV ...  > filename") is used.
  136.  
  137. "/Ox" and "/O-x" allow you to specify the display order for the files.  "x" can
  138. be one of the following:
  139.  
  140.         N = file name
  141.         E = file extension
  142.         D = file date and time
  143.         S = file size of the original (non-compressed) file
  144.         C = current (compressed) size of the file
  145.         R = compression ratio
  146.         P = path and file name order
  147.         O = original order (no sorting)
  148.  
  149. If you precede the "x" with a dash ("-"), the sort  will  be  done  in  reverse
  150. order.  Initially defaults to /OO.
  151.  
  152. "/DATE" resets the archive file date to be the date of the most recent  member.
  153. Automatically invokes /-P.  The command "AV *.* /DATE /Q" is  a  quick  way  to
  154. reset the file date stamps for all archives in your current subdirectory.
  155.  
  156. "/MOUSE" says to activate the mouse if present.  This is initially the default.
  157.  
  158. "/-MOUSE" says to skip activating the mouse even if present.
  159.  
  160. "/Tpath" specifies where to write the temporary ISAM  files  that  the  routine
  161. needs.  ISAM data bases are used to store and sort the file names.  ISAM  files
  162. cannot be created reliably on certain types of drives.  Examples are "/TC:" and
  163. "/TC:\TEMP".  If  not  specified,  the  routine  writes  to  the  following  in
  164. sequence:
  165.  
  166.   - the value of any TEMP, then TMP, environmental variable
  167.   - C:\TEMP
  168.   - C:\
  169.  
  170. "/Q" skips the display of the member names.  Automatically  invokes  /DATE  and
  171. /-P and is typically used in cases where you want to reset all file dates  (for
  172. example, "AV *.* /Q").
  173.  
  174.  
  175. AV.DOC                                 4                           Jul 31, 1997
  176.  
  177. "/EGA" or "/VGA" will put you in 43/50-line mode if your monitor supports this.
  178. The two options are actually synonymous  (you'll  get  the  best  your  monitor
  179. supports).  You can also switch to and from 25-line and 43/50-line mode  within
  180. the program by using Alt-E.
  181.  
  182. "/MONO" (or "/-COLOR") does not  try  to  override  screen  colors.   Initially
  183. defaults to "/COLOR".
  184.  
  185. "/COLOR" (or  "/-MONO")  allows  screen  colors  to  be  overridden.   This  is
  186. initially the default.
  187.  
  188. "/Iinitfile" says to read an initialization file with the file name "initfile".
  189. The file specification *must* contain a period.  Initfiles are described in the
  190. BRUCEINI.DOC file.  Initially defaults to "/IAV.INI".
  191.  
  192. "/-I" (or "/INULL") says to skip loading the initialization file.
  193.  
  194. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  195. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  196. more information.  This is initially the default.
  197.  
  198. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  199. Initially defaults to "/ENV".
  200.  
  201. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  202.  
  203. ">filename" redirects the output to a text file.   This  automatically  invokes
  204. the /-P option.  This is useful for getting a complete listing of the  contents
  205. of your compressed files.  For example:
  206.  
  207.         AV *.* > TEMP.TXT
  208.  
  209.  
  210. Return codes:
  211.  
  212. AV returns the following ERRORLEVEL codes:
  213.  
  214.         0 = no problems
  215.       252 = other problems
  216.       253 = no valid archives were found
  217.       254 = could not find a decent temporary output subdirectory
  218.       255 = syntax problems, file not found, or /? requested
  219.  
  220.  
  221.  
  222. AV.DOC                                 5                           Jul 31, 1997
  223.  
  224. Author:
  225.  
  226. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  227. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  228. program, no changes are made to the program or documentation,  and  it  is  not
  229. bundled with commercial programs or charged for separately.  People who need to
  230. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  231. Software" at the following address.
  232.  
  233. Additional information about this and other  Wayne  Software  programs  can  be
  234. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  235. The recent change history for this and the other programs is  provided  in  the
  236. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  237. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  238. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  239. naming the ZIP file (AVymm.ZIP) that this program was included in.
  240.  
  241. Comments and suggestions can also be sent to:
  242.  
  243.                 Bruce Guthrie
  244.                 Wayne Software
  245.                 113 Sheffield St.
  246.                 Silver Spring, MD 20910
  247.  
  248.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  249.                 http://www.geocities.com/SiliconValley/Lakes/2414
  250.  
  251. Please provide an Internet e-mail address on all correspondence.
  252.  
  253. 
  254.